home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / partnr52.zip / PARTNERS.DOC < prev    next >
Text File  |  1991-09-15  |  88KB  |  2,674 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                EQUAL PARTNERS
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                             Virtual disk system
  27.  
  28.                                 Version 5.20
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                    K.eeping I.nformation S.haring S.imple
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.        "If you know DOS then you already know how to use Equal Partners."
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.      COPYRIGHT (c)  1986, 1987, 1988, 1989, 1990, 1991 by Downlink Systems
  54.      ALL RIGHTS RESERVED
  55.  
  56.  
  57.  
  58.        This document describes the EQUAL PARTNERS virtual disk  system,
  59.       which was created by Downlink Systems, in December of 1986.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                              THE PRIME RULE
  67.                             ----------------
  68.  
  69.            ALWAYS BACK UP ANY DISK, WITH DATA ON IT, THAT  YOU CANNOT
  70.            --------------
  71.  
  72.            RECREATE IN A TIMELY AND COSTLY MANNER OR WHOSE LOSS, EVEN
  73.  
  74.            FOR A  SHORT PERIOD OF TIME,  WOULD HAVE A  SERIOUS IMPACT
  75.  
  76.            ON YOUR NORMAL FLOW OF BUSINESS.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.    DISCLAIMER OF ALL WARRANTIES AND LIABILITY
  104.    ------------------------------------------
  105.  
  106.    Downlink Systems  ("supplier") makes no warranties, either expressed
  107.    or implied, with respect to this documentation or with respect to the
  108.    software  described in  this  publication,  its quality,  performance,
  109.    merchantability or  fitness for any particular purpose. The software is
  110.    sold or licensed "as is". The entire risk as to its quality and performance
  111.    is  with the buyer. Should the programs prove defective following their
  112.    purchase, the buyer  (and not the suppliers, not  their distributor  or
  113.    retailer) assumes the  entire cost of  all necessary servicing, repair,
  114.    or correction and any incidental or  consequential damages. In no  event
  115.    will suppliers be liable for direct, indirect, incidental or consequential
  116.    damages resulting from any defect in the software, even if suppliers have
  117.    been advised of the possibility of such damages. Some states do not allow
  118.    the exclusion  or  limitation of  implied warranties  or  liability  for
  119.    incidental or consequential damages, so the above limitation or exclusion
  120.    may not apply to you.
  121.  
  122.  
  123.  
  124.                                     i
  125.  
  126.                                   INDEX
  127.                                  -------
  128.  
  129.            Disclaimer  ......................................    i
  130.  
  131.            Index       ......................................    ii
  132.  
  133.            Introduction .....................................    iii
  134.  
  135.        I.  WHAT IS EQUAL PARTNERS ...........................     1
  136.  
  137.       II.  WHY USE EQUAL PARTNERS ...........................     1
  138.  
  139.      III.  HOW DO YOU ACQUIRE USAGE RIGHTS ..................     2
  140.  
  141.       IV.  HOW DO YOU USE EQUAL PARTNERS ....................     3
  142.  
  143.        V.  DAILY USAGE ......................................     4
  144.  
  145.       VI.  REQUIREMENTS .....................................     5
  146.  
  147.      VII.  INSTALLATION  ....................................     6
  148.  
  149.                Server   .....................................     7
  150.                Remote   .....................................     8
  151.  
  152.      VIII  REMOTE SHUTDOWN - EXPLAINED ......................    11
  153.  
  154.      IX.   VIRTUAL WRITE PROTECTION - EXPLAINED .............    12
  155.  
  156.      X.    VIRTUAL PRINTER  - EXPLAINED .....................    13
  157.  
  158.      XI.   STATISTICS  - EXPLAINED ..........................    14
  159.  
  160.      XII.  RAMDISK SUPPORT  .................................    15
  161.  
  162.      XIII  PROGRAM  EXECUTION RESTRICTIONS ..................    16
  163.  
  164.      XIV.  DISK DRIVE MAPPING  ..............................    17
  165.  
  166.      XV.   HOW SOME CUSTOMERS ARE USING EQUAL PARTNERS ......    21
  167.  
  168.      XVI   PROGRAM UPDATE SERVICE  ..........................    22
  169.  
  170.      XVII  VERSION NUMBERS  .................................    23
  171.  
  172.      XVIII TECHNICAL REQUIREMENTS AND NOTES .................    24
  173.  
  174.            Appendix A - Program Messages ....................    A1
  175.  
  176.            Appendix B - Site License ........................    B1
  177.                       - Commercial License agreement.........    B2
  178.  
  179.            Appendix C - Ordering ............................    C1
  180.  
  181.            Appendix D - Comments ............................    D1
  182.  
  183.            Appendix E - Mailing  ............................    E1
  184.  
  185.                                    ii
  186.  
  187.  
  188.                                   INTRODUCTION
  189.  
  190.  
  191.  
  192.       EQUAL PARTNERS is the copyrighted property of Downlink Systems.
  193.       You are granted a limited license to use , and to copy it and
  194.       distribute it, provided that the following conditions are met:
  195.  
  196.       1) No fee may be charged for such copying and distribution.
  197.  
  198.       2) EQUAL PARTNERS may ONLY be distributed in its original, unmodified
  199.          state.
  200.  
  201.       The mailing address, when you decide to register Equal Partners,is placed
  202.       here at the start, but see the order form in the appendix:
  203.  
  204.                               D. Conner
  205.                               Downlink Systems
  206.                               5226 Via Hacienda
  207.                               #115
  208.                               Orlando Fl,
  209.                                               32809
  210.                               U.S.A.
  211.  
  212.       You may NOT use this product in a commercial environment or a
  213.       governmental organization without paying a license fee of $40.
  214.  
  215.       A program disk ,printed documentation and 'special' parallel
  216.       adapter are available for $40.00 U.S. only.
  217.  
  218.       See the order form in the back of this manual for more details.
  219.  
  220.  
  221.       EQUAL PARTNERS is user supported software.  This means that you may
  222.       copy the shareware version freely and give the copies away to anyone
  223.       you wish, at no cost. They are requested to register their copy, if
  224.       they decide to continue to use Equal Partners.
  225.  
  226.       The user supported software concept (often referred to as shareware)
  227.       is an attempt to provide software at low cost.  The cost of offering a
  228.       new product by conventional means is staggering, and hence dissuades
  229.       many independent authors and small companies from developing and
  230.       promoting their ideas.  User supported software is an attempt to
  231.       develop a new marketing channel, where products can be introduced at
  232.       low cost.
  233.  
  234.       If user supported software works, then everyone will benefit.  The
  235.       user will benefit by receiving quality products at low cost, and by
  236.       being able to "test drive" software before purchasing it.
  237.        The author benefits by being able to enter the commercial software
  238.       arena without first needing large sources of venture capital.
  239.  
  240.       But it can only work with your support.  We're not just talking about
  241.       EP here, but about all user supported software.  If you obtain a user
  242.       supported program from a friend or colleague, and are still using it
  243.       after a couple of weeks, then it is obviously worth something to you,
  244.       and a contribution should be sent. Upon receipt of a contribution,
  245.       you become a registered user and will receive a "full" feature, serial-
  246.       ized version of EQUAL PARTNERS.
  247.  
  248.                                    iii
  249.  
  250.  
  251.  
  252.  
  253.  
  254.    I. WHAT IS EQUAL PARTNERS.
  255.       -----------------------
  256.  
  257.         Equal Partners is a software solution to the problem of sharing data
  258.       between 5 1/4 floppy based PCs and the new IBM PS/2s, convertibles,
  259.       lap-tops that use the 3 1/2 floppy drives  (720K and 1.4 meg) ,
  260.       between different PCs with dissimilar disk(ette) storage media,
  261.       or between different PCs with identical recording media!.
  262.  
  263.         Equal Partners addresses this problem by using inexpensive RS-232
  264.       serial or parallel adapters.  Software device drivers and communication
  265.       programs attach the physical devices of one PC to the DOS operating
  266.       system of another PC. These physical devices become an extension of and
  267.       to the operating system of the other PC so that all DOS functions that
  268.       use a device letter, to access data, function without concern that
  269.       these 'virtual' devices are not truly physically attached to the
  270.       floppy/hard disk controller cards and printers.
  271.  
  272.  
  273.   II. WHY USE EQUAL PARTNERS
  274.       ----------------------
  275.  
  276.        Equal Partners provides a cost effective solution, as opposed to
  277.       other similar commercially available products, or to the hardware
  278.       solution that IBM provides. IBM's solution is an external 5.25 drive
  279.       and requires an additional out-of-pocket expense in the neighborhood
  280.       of $400.00. Equal Partners allows you to try its low cost solution
  281.       for a reasonable time.
  282.  
  283.  
  284.        We are sure you would rather use the $400.00 you saved, to invest,
  285.       expand and/or enrich your life in other ways.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                     - 1 -
  311.  
  312.  
  313.  
  314.  III. HOW DO YOU ACQUIRE USAGE RIGHTS TO EQUAL PARTNERS.
  315.       ---------------------------------------------------
  316.  
  317.        Equal Partners is not totally free, a small contribution is asked
  318.       to allow the authors to feel that their efforts did not fall on
  319.       unfertile ground.
  320.  
  321.        The contribution can consist of several forms:
  322.  
  323.        FOR INDIVIDUALS
  324.        ----------------
  325.  
  326.           1). Monetary
  327.               --------
  328.  
  329.              A registration and usage fee of $40.00 is asked, of individuals.
  330.             This will provide you with notices of  upgrades and fixes, as well
  331.             as allow you access to a version supporting parallel ports and
  332.             faster transfer speeds plus other additional features.
  333.  
  334.              You may now call a 1-800 number to place a credit card order.
  335.  
  336.  
  337.           2). Personal - applies to usage of "restricted usage" version
  338.               --------
  339.  
  340.              Another alternative, if money is a major negative factor, is that
  341.             we deeply request that you give a part of yourself. Instead of a
  342.             pound of flesh, a donation to  your local Red Cross of 1 pint of
  343.             blood so that another may 'profit' from your 'gain'/'loss'. This is
  344.             the least  contribution asked and expected. Again, this request
  345.             applies to  you if you  continue to  use the 'restricted usage'
  346.             Shareware version, without registering.
  347.  
  348.  
  349.         FOR COMPANY
  350.         ------------
  351.  
  352.           1). Monetary
  353.               --------
  354.  
  355.                For businesses, that benefit from additional utility and time/
  356.               cost savings, a PER COPY or site-license is available and REQUIRED
  357.               ,otherwise, NO usage license is granted, and any use is strictly
  358.               prohibited.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.                                     - 2 -
  373.  
  374.  
  375.  
  376.  
  377.  
  378.   IV. HOW DO YOU USE EQUAL PARTNERS
  379.       -----------------------------
  380.  
  381.        First read the section on REQUIREMENTS, to see if your machine
  382.       and its hardware configuration can meet the necessary requirements.
  383.  
  384.        Secondly, install Equal Partners (see INSTALLATION section). Now the
  385.       easy part begins.
  386.  
  387.        You say, "nothing is ever easy". We say , "if you know DOS then you
  388.       know how to use Equal Partners".
  389.  
  390.        Granted you may not, yet, be a "POWER USER", but we bet you know how
  391.       to see what's on your disks, does the "DIR" command ring a bell. Now that
  392.       you know what's there, we also bet you got it there with the DOS "COPY"
  393.       command or with your favoriate DOS menu shell. Starting to catch on yet,
  394.       we haven't tried to teach you any new convoluted commands with unfamiliar
  395.       structure and syntax , have we. Guess what!!. You have just graduated from
  396.       the ACME self study and enlightenment course that certifies you as a
  397.       "POWER USER" of Equal Partners. Take a break, you deserve it. Oh, come
  398.       back later to get your EPPU 'certificate of achievement'.
  399.  
  400.        Back so soon?.
  401.  
  402.       Now to the serious business side of matters. You have all this data
  403.       , in some form or another, and you need to :
  404.  
  405.              consolidate/manipulate/share/archive/transport
  406.  
  407.       it between/among/with/to another/same media on another PC.
  408.  
  409.        Being a Equal Partners "POWER USER" (EPPU), you know that all you
  410.       have to do is use the DOS "COPY" command or mark and select with your
  411.       favoriate DOS menu shell .
  412.  
  413.        So, do it, and give yourself a pat on the back for a job well done.
  414.  
  415.        We could go on with how to use the other DOS commands, but we are
  416.       sure you are ahead of us already. What more can we say, in 25 words
  417.       or less, that would not confuse you. Again let us stress, if you
  418.       need to access data on the 'server' PC, just use the DOS commands
  419.       or your DOS menu shell and the disk drive letters of the 'virtual drives'
  420.       that are now logically attached to your PC.
  421.  
  422.        Also, we are sure that you have guessed by now, that if you can
  423.       tell DOS where to get the data you need, for a program it should
  424.       be just as easy. Sure is, just 'tell' the program that the data it
  425.       needs is on one of the 'virtual drives' and business should
  426.       continue as always (unless that 'break-even' analysis formula
  427.       in the spreadsheet is in error).
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.                                     - 3 -
  435.  
  436.  
  437.    V. DAILY USAGE
  438.       ------------
  439.  
  440.        The daily use of EQUAL PARTNERS  begins with typing in the following
  441.       command on the "remote" or including it in a batch file:
  442.  
  443.                 EQUAL /device /port
  444.  
  445.        The daily use of EQUAL PARTNERS  begins with typing in the following
  446.       command on the "server" or including it in a batch file:
  447.  
  448.                 PARTNERS  /device /port
  449.  
  450.  
  451.         (where: '/device'  is  '/C' or '/L',  and  '/port'  is  '1' or '2'.)
  452.  
  453.  
  454.        (Consult the INSTALLATION section for additional command options.)
  455.  
  456.  
  457.        Then, ANY DOS command or software package (menu, shell..etc) that
  458.       uses DOS to perform file related functions will be able to perform
  459.       these same functions on the "virtual" devices,  such as disks or
  460.       printers.
  461.  
  462.        (for example: MS Windows, DOS 4.0 Shell, XTREE, 1DIR, NORTON, PCTOOLS,
  463.                      AUTOMENU, DBASE, WP..etc)
  464.  
  465.        To return to DOS on the "server", once PARTNERS is running, press
  466.       the "ESC" key.
  467.  
  468.  
  469.        A WARNING: NEVER return to DOS, on the "server" if you still have
  470.                  files in use from the "remote". Always exit the applica-
  471.                  tion(s) on the "remote" before shutting down PARTNERS on
  472.                  the server.
  473.  
  474.  
  475.  
  476.        You may then re-activate the link to the "remote" from the server,
  477.       (at any time) by again typing in the command: PARTNERS.
  478.  
  479.  
  480.        Once EQUAL is running , in resident mode, on the "remote", you may
  481.       inquire as to the original install environment and option settings
  482.       by typing in the command :
  483.  
  484.                  EQUAL
  485.  
  486.        The EQUAL operating mode on the "remote" may be changed at any time,
  487.        by typing in the command:
  488.  
  489.                  EQUAL  option-setting
  490.  
  491.        with the correct option setting. Some options act as on/off switches,
  492.        in that if specified will turn the option on (if off) or off (if on).
  493.        The current status of options displayed , reflects the processing
  494.        state AFTER all command line options are processed.
  495.  
  496.                                     - 4 -
  497.  
  498.  
  499.  
  500.   VI. REQUIREMENTS
  501.       ------------
  502.  
  503.       The hardware requirements are:
  504.  
  505.           1). Your machine must be an IBM PS/2,PC/XT/AT or highly compatible,
  506.              including laptops and convertibles.
  507.  
  508.           2). The machine uses an 8250 uart,or compatible, to handle
  509.              the RS232C communications. This requirement is now verified
  510.              by the Equal Partners software.
  511.  
  512.           3). The machine uses a parallel adapter card that can support
  513.              bi-directional transfer. Not all parallel cards were manufactured
  514.              to function as required by Equal Partners. Most clone parallel
  515.              cards you can buy today will allow Equal Partners to be run
  516.              to utilize the parallel port feature. You may have to upgrade
  517.              your parallel cards (most are available for $20-$30).
  518.  
  519.           4). The RS232C cable must have pins 2 and 3 crossed or
  520.              a straight thru cable with a null modem (see diagram),
  521.              for serial ONLY.
  522.  
  523.              NOTE: a 'null modem' is NOT a real modem but only a cable with
  524.                   a special wiring arrangement.
  525.  
  526.                                -or-
  527.  
  528.               A 'special' parallel adapter is supplied by DownLink Systems
  529.              when you register. The adapter attaches to any 25-pin serial
  530.              cable. A well insulated cable is recommended for maximum distance
  531.              between PC. Ten (10) feet is the normal maximum distance with a
  532.              good shielded cable.
  533.  
  534.           5). The machine uses the port addresses at memory location
  535.              0:400. The port addresses are normally 03F8 for COM1,
  536.              and 02F8 for COM2 (depending on hardware setup).
  537.  
  538.                                   -or-
  539.  
  540.               The machine uses the port addresses at memory locations
  541.              0:408, for the parallel option. The port addresses are normally
  542.              03BC for LPT1 and 0378 for LPT2.
  543.  
  544.           6). The disk media must be DOS formatted, in other words
  545.              the boot sector must contain the BPB info that describes
  546.                              -------------------------
  547.              the media (the media type in the FAT is not used). Some
  548.              vendors that format their own disks do not bother to put
  549.              the BPB info in logical sector 0, even thought the DOS 3.2
  550.              Technical Ref. manual says that DOS will no longer rely
  551.              on the Media code in the FAT to determine the device
  552.              characteristics. This requirement has been relaxed by EP
  553.              version 5.20.
  554.  
  555.           7). As always, sufficient memory must be available.
  556.  
  557.  
  558.                                     - 5 -
  559.  
  560.  
  561.       The software requirements are:
  562.  
  563.           1). The operating system must be IBM PC DOS 2.0 or above.
  564.  
  565.               This product has been tested on IBM PC DOS 2.0 , 2.10,
  566.              3.00, 3.10, 3.20, 3.21 , 3.30 and IBM DOS 4.0x and some
  567.              versions of MS DOS. Also supports Compaq DOS 3.31+ for
  568.              drives greater than 32 meg.
  569.  
  570.           2). The PC DOS versions running on both the "server" and
  571.              the "remote(s)" MUST/SHOULD be identical!!.
  572.  
  573.               If the server and remote(s) are running different versions
  574.              of DOS, the PC with the LATEST version of DOS MUST be
  575.                                                            ----
  576.              configured as the "REMOTE". This will INSURE that your
  577.              disk(ette)s will not be destroyed.
  578.  
  579.              (NOTE: The ABOVE ESPECIALLY applies to ROM based DOS PCs)
  580.               --------------------------------------------------------
  581.              ALWAYS do the DOS command, DIR, on each of the disks on
  582.              ------
  583.              the server. If the reply to the DIR is garbled or you do not
  584.              think/know it is correct then DO NOT attempt any DOS commands
  585.              that transfers data to/from the remote and the server.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                                    - 5a -
  621.  
  622.  
  623.  
  624.  VII. INSTALLATION
  625.       ------------
  626.  
  627.       Equal Partners consists of the following files:
  628.  
  629.             50-50.SYS       -  device driver
  630.  
  631.             EQUAL.COM       -  communication program
  632.  
  633.             PARTNERS.COM    -  communication program
  634.  
  635.             PARTNERS.DOC    -  this documentation
  636.  
  637.             SERVER.BAT      -  example batch file, with ERRORLEVEL checking
  638.  
  639.             REMOTE.BAT      -  example batch file, with ERRORLEVEL checking
  640.  
  641.             README.DOC      -  revision history and additional comments
  642.  
  643.             ????????.???    -  any additional files as the product matures
  644.  
  645.  
  646.        Installation assumes two PCs, and the need to exchange data
  647.       between the PCs. One PC will be designated the 'server' PC
  648.       and the other PC(s) the 'remote' PC(s).
  649.  
  650.  
  651.        The PARTNERS.COM program may be loaded on and is normally run
  652.       from the 'server' PC. The 'server' PC could be considered the 'base'
  653.       PC in that it would normally contain all the master database and
  654.       spreadsheet programs and files. The 'remote' PC(s) could be lap-tops
  655.       that individuals had taken 'on-the-road' with them to gather data,
  656.       for updating to the 'server' databases..etc.
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.                                     - 6 -
  683.  
  684.  
  685.  
  686.       So, installation on the 'server' of PARTNERS.COM consists of
  687.                        --------------
  688.  
  689.          1). Copying PARTNERS.COM to a directory in the DOS path,
  690.              and typing the command , 'PARTNERS' or including it in
  691.              a DOS batch file (SEE the batch file "SERVER.BAT" included).
  692.  
  693.  
  694.              Command format:
  695.              ---------------
  696.  
  697.  
  698.                PARTNERS /option/option...
  699.  
  700.                at a mininum the type of adapter (serial/parallel) and
  701.               port, options , MUST be specified at installation.
  702.  
  703.  
  704.              OPTION
  705.              ------
  706.               /C   - uses serial card to be used as "bridge" to communicate
  707.                     with the remote (EQUAL).
  708.  
  709.               /L   - uses parallel card to be used as "bridge" to communicate
  710.                     with the remote (EQUAL).
  711.  
  712.               /1   - causes COM1 or LPT1 to be used as "bridge" to communicate
  713.                     with the remote (EQUAL).
  714.  
  715.               /2   - causes COM2 or LPT2 to be used as "bridge" to communicate
  716.                     with the remote (EQUAL).
  717.  
  718.               /V   - ALLOW different DOS version on the remote.
  719.  
  720.               /D   - allow server (PARTNERS) to be shutdown from a remote.
  721.                     (this option may be turned on/off while PARTNERS running)
  722.  
  723.               /Q   - QUITE mode, don't display "logo" or other messages, except
  724.                     errors.
  725.  
  726.               /P   - allow server (PARTNERS) to process print from a remote
  727.                     (this option may be turned on/off while PARTNERS running)
  728.  
  729.               /W   - allows or inhibits writing to disk drives by a remote.
  730.                     Effectively same as placing a write-protect tab on a disk.
  731.                     (this option may be turned on/off while PARTNERS running)
  732.  
  733.               /H   - display a HELP screen (all other options are ignored)
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.             Note: The DEFAULT option settings are "off" unless noted otherwise.
  741.  
  742.             Note: the install results may be tested in a batch file with
  743.                   the ERRORLEVEL statement (SEE file "SERVER.BAT).
  744.  
  745.  
  746.                                     - 7 -
  747.  
  748.       Now, installation on the 'remote' consists of
  749.                         --------------
  750.  
  751.           1). Including the following command in 'CONFIG.SYS'
  752.  
  753.               DEVICE=50-50.SYS  'z' additional disk drives requested
  754.  
  755.               (where 'z' can be any number from 1 to 8, default=1)
  756.  
  757.           2). Re-boot, press CTRL-ALT-DEL or power off the remote PC, and
  758.              power PC back on . This causes the "50-50.sys" statement to
  759.              add the additional 'virtual' disk drives to the 'remote' PC.
  760.  
  761.               Now continue with the next step, below.
  762.  
  763.            Note: steps 1 and 2 (above) are only necessary when EP is
  764.                 initially installed.
  765.  
  766.           3). Copying EQUAL.COM to a directory in the DOS path
  767.               and typing the command, 'EQUAL' or including it in
  768.               a DOS batch file (SEE batch file "REMOTE.BAT" included).
  769.  
  770.             Command format:
  771.             ---------------
  772.  
  773.                EQUAL  /option/option..
  774.  
  775.                at a minimum the type of adapter (serial/parallel) and
  776.               port, options , MUST be specified at installation.
  777.  
  778.             OPTION
  779.             ------
  780.              /C   - uses serial card to be used as "bridge" to communicate
  781.                     with the server (PARTNERS).
  782.  
  783.              /L   - uses parallel card to be used as "bridge" to communicate
  784.                     with the server (PARTNERS).
  785.  
  786.              /1   - causes COM1 or  LPT1 to be used as "bridge" to communicate
  787.                     with the server (PARTNERS).
  788.  
  789.              /2   - causes COM2 or LPT2 to be used as "bridge" to communicate
  790.                     with the server (PARTNERS).
  791.  
  792.              /V   - ALLOW different DOS version on the server.
  793.  
  794.              /N   - Normal processing mode. This is the DEFAULT. ONLY mode
  795.                    supported when parallel is selected.
  796.  
  797.              /T   - Turbo  processing mode. It is 4-5 times faster than
  798.                     Normal mode (for serial ONLY).
  799.  
  800.              /D   - send request to server (PARTNERS) to shutdown and return
  801.                     to DOS. May only be requested once EQUAL installed.
  802.  
  803.              /P   - directs the remotes LPT1 print to the server or remote.
  804.  
  805.              /Q   - QUITE mode, don't display "logo" or other messages, except
  806.                    errors.
  807.  
  808.              /R   - RESET the SERIAL port communications link.
  809.  
  810.              /H   - display a HELP screen (all other options are ignored).
  811.  
  812.                                     - 8 -
  813.  
  814.  
  815.           NOTE: A few words are in order about the 'V' option. As has been
  816.                 STRESSED, if the DOS version running on the 'remote' is
  817.                 LESS than the DOS version running on the 'server', there is
  818.                 a good chance that you could corrupt the disk on the server by
  819.                 reading/writing from it. Each version of DOS ONLY knows how to
  820.                 handle specific disk drive types. For example DOS 2.x dosnt know
  821.                 how to handle 1.2 meg disks or hard disks greater than 16 meg
  822.                 as well as drives greater than 32 meg.
  823.  
  824.                 However, we have had several users that have caused themselves
  825.                 problems by NOT adhering to the 'rules'. So, to protect you
  826.                 and your data, we have forced Equal Partners NOT to allow
  827.                 you to read/write to the 'server' IF the DOS's running on the
  828.                 'server' and the 'remote' DO NOT match. If you KNOW what
  829.                 you are doing, THEN the 'V' option REMOVEs this safety check.
  830.  
  831.                 You can STILL try and read the 'servers' disk drives from the
  832.                 'remote' and see if the 'remotes' DOS knows how to process
  833.                 the 'servers' drive types. Again, do the DOS 'DIR' command
  834.                 from the 'remote' if not sure. If the results NOT what could
  835.                 be considered normal ( i.e garbled directory list or the
  836.                 'remote' sees only 10 meg drive on the 'server' when you
  837.                 know that the drive on the 'server' is a 20 meg), then DONT
  838.                 read/write from the server. Try reversing the 'server/remote'
  839.                 configuration, as the first step.
  840.  
  841.           NOTE: The processing modes "N","T" may be changed at any time
  842.                after EQUAL has been installed, just by specifying the new
  843.                option on the command line (for serial ONLY).
  844.  
  845.  
  846.                 The TURBO mode applies ONLY to usage of the serial port.
  847.                     ---------------------------------------------------
  848.  
  849.                 The NORMAL mode is the SAFEST mode in a mixed PC hardware
  850.                configurations. The TURBO mode is the FASTEST, but you may
  851.                experience some errors in a mixed PC hardware configuration
  852.                linking totally dissimilar PCs.
  853.  
  854.                 For example, linking a 10+ mhz AT class PC to a 4.77 mhz
  855.                class PC  may cause problems in TURBO mode, if so switch
  856.                to NORMAL mode and everything WILL be OK. If the hardware
  857.                speed of the PCs are within a few mhz of each other, then
  858.                TURBO mode would be your best operating mode.
  859.  
  860.  
  861.           NOTE: The re-direction of local remote print to the server may
  862.                be turned on/off at any time after EQUAL is installed, just
  863.                by specifying the "/P" option on the command line. You don't
  864.                need a physical printer LPT1 on the remote to use printer
  865.                re-direction to server option. If you do though, the remotes
  866.                local LPT1 is temporarily overridden (disabled) until the
  867.                "/P" is again entered. Printer output cannot be directed
  868.                to the same parallel port EQUAL PARTNERS is using as a 'bridge'
  869.                to the other PC.
  870.  
  871.                 Specifying the "/D" option no longer automatically turns off
  872.                printer re-direction (if on) and returns LPT1  printer support
  873.                to DOS on the remote. Printer re-direction MUST be turned off
  874.                before a remote shutdown request will function.
  875.  
  876.                                     - 9 -
  877.  
  878.  
  879.           NOTE: The options, "/D" and "/P" require that the corresponding
  880.                options be turned "on" at the server, otherwise the
  881.                operation of these options are ignored (or return error
  882.                condition) by the server.
  883.  
  884.           NOTE: The options default settings are "off" unless noted
  885.                otherwise.
  886.  
  887.           NOTE: the install results may be tested in a batch file with
  888.                the ERRORLEVEL statement (SEE file "REMOTE.BAT).
  889.  
  890.           NOTE:  including a "{" or "(" or "[" on the command line, will
  891.                 make the rest of the command line serve as "remarks",so that
  892.                 you can add comments at the end of the valid parameters.
  893.  
  894.         Once installed , any DOS command that would normally access data
  895.        using a drive designation, will be able to read/write data from
  896.        one PC to the other PC(s). What this means is that you can 'COPY',
  897.        'ERASE', 'RENAME', 'PATH', and execute programs to/on/from the
  898.        'virtual' drives without any new commands or procedures.
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.         If you know DOS then you already know how to use Equal Partners.
  938.  
  939.                                    - 10 -
  940.  
  941.  
  942.  
  943.  
  944.  VIII REMOTE SHUTDOWN - EXPLAINED.
  945.       ---------------------------
  946.  
  947.  
  948.        The term 'remote shutdown' refers to the act of the server (PARTNERS)
  949.       shutting down (returning to DOS) at the request of a remote (EQUAL)
  950.       PC. This option has been added to EQUAL PARTNERS as the result of
  951.       several inquiries into this capability.
  952.  
  953.        First, this option must be 'turned on' at the server. This may be
  954.       done when the PARTNERS program is started, with the '/D' option or
  955.       pressing the appropriate function key after PARTNERS is running.
  956.  
  957.        This option may be toggled (turned off/on) at any time while
  958.       PARTNERS is running. You may only want to allow the server to be
  959.       shutdown when certain remotes are attached. The remote PC requests
  960.       the server to shutdown  by invoking the EQUAL command with the
  961.       '/D' option. The results of the remotes shutdown request to the
  962.       server may be tested in a batch file, using the DOS ERRORLEVEL
  963.       statement (see the REMOTE.BAT file included as an example)
  964.  
  965.        The ideal use of this option would be , for example, if the remote
  966.       PC(s) had transferred data to the server and the normal next step
  967.       would be for the server to process the data. The process could be
  968.       calling up a speadsheet or a database or a communications program
  969.       to further manipulate the data.
  970.  
  971.        So, to facilitate this repetitive process a batch file could be
  972.       set up to invoke PARTNERS and THEN when PARTNERS was shutdown
  973.       , the batch file could test the ERRORLEVEL code OR test for
  974.       the existence of the data files that should have been transferred.
  975.  
  976.        The batch file would then invoke any application necessary to
  977.       immediately process the data. After the application had processed
  978.       the data, PARTNERS could be automatically restarted to pass back the
  979.       results of the applications manipulation of the data.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.                                    - 11 -
  1002.  
  1003.  
  1004.  
  1005.  
  1006.   IX. VIRTUAL WRITE PROTECTION - EXPLAINED.
  1007.       -------------------------------------
  1008.  
  1009.  
  1010.        The term 'virtual write protection' refers to the refusal of the
  1011.       server (PARTNERS) PC to allow ANY disks (real or ram or otherwise)
  1012.       that it is aware of to be written to. The reason for this option
  1013.       is because, from a remotes viewpoint all server disks that it has
  1014.       access to are removable (much like a real floppy disk).
  1015.  
  1016.        You may want to restrict write/update access to the servers disks
  1017.       at any point in time. This may be the case where you only want the
  1018.       users whose remotes are attached to be able to only read data from
  1019.       the server.
  1020.  
  1021.        Virtual write protection is functionally the same as your putting
  1022.       that little silver/black write protect tab on a floppy disk or by
  1023.       moving the tab on a 3.5 micro floppy to the correct position.
  1024.  
  1025.        This option may be turned on when PARTNERS first started by adding
  1026.       the '/W' options to the PARTNERS command. Likewise this option may
  1027.       be toggled (turned off/on) after PARTNERS is running by pressing the
  1028.       appropriate function key.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                                    - 12 -
  1064.  
  1065.  
  1066.  
  1067.  
  1068.   X.  VIRTUAL PRINTER  - EXPLAINED.
  1069.       ------------------------------
  1070.  
  1071.  
  1072.        The term 'virtual printing' refers to the act of transferring output
  1073.       from an application (DOS or otherwise) to a physical printer that
  1074.       may or may not be attached to the remote PC.
  1075.  
  1076.        The printer is a 'virtual printer' if the printer is attached to
  1077.       the server and the remote PC re-directs its local printer LPT1
  1078.       to the server. This re-direction is accomplished by appending the
  1079.       '/P' option to the command : EQUAL. On the remote the '/P' option
  1080.       acts as a toggle (directs print to remote or server alternately).
  1081.  
  1082.  
  1083.  
  1084.  
  1085.        The server will only process the remotes re-directed print request
  1086.       if that service is 'on' at the server. Virtual printer support may
  1087.       be activated when PARTNERS is started by adding the '/P' option to
  1088.       the PARTNERS command or by pressing the appropriate function key
  1089.       after PARTNERS is started.
  1090.  
  1091.  
  1092.        The server wil NOT support remote printing if the parallel port
  1093.       is being used to 'bridge' the PCs and the SAME parallel port is
  1094.       trying to be used to write application output to a printer.
  1095.  
  1096.  
  1097.        The remote DOS PRINT will stop printing to the server while the virtual
  1098.       disks are being accessed, but will automatically start back when the
  1099.       virtual disk accessing is through.
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                                    - 13 -
  1126.  
  1127.  
  1128.  
  1129.  
  1130.   XI.   STATISTICS  - EXPLAINED
  1131.         -----------------------
  1132.  
  1133.  
  1134.        The 'server' (PARTNERS) machine maintains a count of the number of
  1135.       read/write requests made by the 'remote'. This count is for the number
  1136.       of sectors of data requested. A sector is normally 512 bytes. This is
  1137.       the smallest amount of data that is stored on a disk, even if you only
  1138.       create a 1 byte file. When you format a disk with the DOS FORMAT
  1139.       command , the disk is logically divided in groups of 512 bytes
  1140.       (called clusters).
  1141.  
  1142.        However , ram disks and other non-standard disks can have sector
  1143.       sizes of 128 or 256 bytes also (see the DOS VDISK command in your DOS
  1144.       manual).
  1145.  
  1146.        Equal Partners works at the DOS level to provide you with 'virtual'
  1147.       disks. If you transfer a file from the server to the remote, there
  1148.       is ADDITIONAL information required and transfered. DOS requires
  1149.       information from the servers directory as well as from the FAT table
  1150.       (File Allocation Table). So you can see, if you transfer a 32,000 byte
  1151.       file from the server to the remote, there is at least  2000-3000 bytes
  1152.       of additional information ALSO being transfered to allow DOS to find
  1153.       and catalogue the file you need (depending on disk size and DOS version).
  1154.  
  1155.        To correctly figure how many characters of information you are tranfer-
  1156.       ing per second to/from the server you MUST not only take into account
  1157.       the file size but ALSO the DOS overhead requirements.
  1158.  
  1159.        The basic formula for calculating the effective file transfer rate is:
  1160.  
  1161.  
  1162.         Characters per seconds= (((# sectors read + # sectors written)
  1163.                                   * units sector size)
  1164.                                + ((# control packets read + # packets written)
  1165.                                   * 20 bytes))
  1166.                                 / number of seconds to read/write data
  1167.  
  1168.  
  1169.        The accumulated usage counts may be displayed by pressing the 'F5' key
  1170.       , on the server PC. Pressing the 'F6' key will clear/reset the counts.
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                                    - 14 -
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  XII. RAMDISK SUPPORT
  1193.       ---------------
  1194.  
  1195.  
  1196.        If you have a RAM disk, or other high-speed storage, then you can speed
  1197.       up EP  somewhat by telling DOS to read from/write to the RAM disk.
  1198.       You do this by substituting the drive letter of the RAM disk in all
  1199.       the DOS commands.  For example, if drive H: is your virtual RAM disk,
  1200.       then you would type:
  1201.  
  1202.            COPY H:*.*  D:
  1203.  
  1204.            (where D: could be a RAM disk on your 'remote' PC)
  1205.  
  1206.  
  1207.        RAM disks in real memory (memory below 640k) and RAM disks in extended
  1208.       memory  (memory above 1 meg on 80286 and 386 PCs) are supported on both
  1209.       the server and the remote(s).
  1210.  
  1211.       Refer to the DOS manual for more details about the DOS commands.
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.                                    - 15 -
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  XIII PROGRAM  EXECUTION RESTRICTIONS
  1255.       -------------------------------
  1256.  
  1257.  
  1258.        If you are using a Shareware version of EQUAL PARTNERS, and have not
  1259.       registered, then the following program execution restrictions
  1260.       apply:
  1261.  
  1262.  
  1263.             1). 38.4kb baud transfer rate is available.
  1264.  
  1265.             2). The Shareware version 5.2 will be FULLY functional UNTIL
  1266.                 1992, in other words version 5.2 will perform ALL functions
  1267.                 correctly,then at start of 1992 will cease functioning.
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.         The SHAREWARE version of EQUAL PARTNERS is NOT A DEMO version.
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.                                    - 16 -
  1312.  
  1313.  
  1314.  
  1315.  XIV.  DISK DRIVE MAPPING
  1316.        -------------------
  1317.  
  1318.  
  1319.        This simple illustration shows how the drives and the letters
  1320.       assigned are mapped to the physical vs. virtual drives.
  1321.  
  1322.  
  1323.  
  1324.  
  1325.             'REMOTE'                                         'SERVER'
  1326.  
  1327.         +---------------+                                +---------------+
  1328.         |  +---------+ o|                                |  +---------+ o|
  1329.         |  |A:>dir C:| o|                                |  | Partners| o|
  1330.         |  |         |  |                                |  |   v5.20 |  |
  1331.         |  |Volume in|  |                                |  |Copyright|  |
  1332.         |  +---------+  |                                |  +---------+  |
  1333.         +---------------+                                +---------------+
  1334.    +------------------------+                       +------------------------+
  1335.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  1336.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  1337.    |                        |<--       ----         |                        |
  1338.    +------------------------+  |                    +------------------------+
  1339.               ^         ^      |        ^                      ^         ^
  1340.               |         |      |        |                      |         |
  1341.               |         |      |        |                      |         |
  1342.           Physical  Physical   |      Null                 Physical  Physical
  1343.           Drive A:  Drive B:   |     Modem                 Drive A:   Drive B:
  1344.                                |        |
  1345.                                |       or                      ^         ^
  1346.                                |    'special'                  |         |
  1347.                                |     parallel                  |         |
  1348.                                |     adapter                   |         |
  1349.                                |
  1350.                                ------------------------->  Virtual   Virtual
  1351.                                                            Drive C:  Drive D:
  1352.  
  1353.  
  1354.       There may be Ram disks on either or both the 'server' and  'remote'
  1355.      PCs. Ram disks are highly recommended, memory permitting, because this
  1356.      eliminates all the mechanical delays that real hardware drives exhibit,
  1357.      such as rotational delay, seek times and drive startup..etc.
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.                                    - 17 -
  1374.  
  1375.  
  1376.  
  1377.                              Usage Example NO. 1
  1378.  
  1379.  
  1380.  
  1381.        This simple illustration shows how EQUAL PARTNERS was used to
  1382.       dial a remote BBS, with PCTALK III  and transfer data to/from
  1383.       the "server" while BBS communications was maintained on the
  1384.       "remote". This example was actual used by the authors.
  1385.         We could also invision a BBS being run on the "remote" and the
  1386.       "server" being used as non-dedicated aux. storage for the BBS.
  1387.  
  1388.  
  1389.                 |
  1390.                 | ^
  1391.                 | |
  1392.                 | --------- to phone line
  1393.            +--------+
  1394.            |  o o o | <----- external modem
  1395.            +--------+
  1396.                 |
  1397.                 | Com2
  1398.                 |
  1399.                 |
  1400.             'REMOTE'                                         'SERVER'
  1401.  
  1402.         +---------------+                                +---------------+
  1403.         |  +---------+ o|                                |  +---------+ o|
  1404.         |  |A:>PC-TAL| o|                                |  | Partners| o|
  1405.         |  |         |  |                                |  |   v5.20 |  |
  1406.         |  |         |  |                                |  |Copyright|  |
  1407.         |  +---------+  |                                |  +---------+  |
  1408.         +---------------+                                +---------------+
  1409.    +------------------------+          Com1         +------------------------+
  1410.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  1411.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  1412.    |                        |          ----         |                        |
  1413.    +------------------------+                       +------------------------+
  1414.                                         or
  1415.  
  1416.                                        LPT1
  1417.  
  1418.                                      'special'
  1419.                                       parallel
  1420.                                       adapter
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.                                    - 18 -
  1436.  
  1437.  
  1438.  
  1439.                              Usage Example NO. 2
  1440.  
  1441.  
  1442.         This simple illustration shows how EQUAL PARTNERS could be used
  1443.        to collect data from various other PCs. As an example, lets say
  1444.        that you are in the insurance business. Your company has an AT
  1445.        in the home office and you have your agents out in the field
  1446.        taking orders and collecting premiums. The agents were given
  1447.        lap-tops , with 3.5 drives. Now you need to get the information
  1448.        stored on the lap-tops to the AT to update the databases.
  1449.  
  1450.         The PARTNERS half of EQUAL PARTNERS could be activated on the
  1451.        AT and as each agent comes in they just "plug" into the RS232
  1452.        cable attached to the AT. PARTNERS, on the AT, does not care what
  1453.        the other devices are on the end of the RS232 cable at any given
  1454.        time. PARTNERS will automatically adjust to the drive character-
  1455.        istics of what ever "remote" drive unit it reads. So, you can
  1456.        "plug" into the cable attached to the AT, then when through,
  1457.        "unplug" and "plug" in another "remote", whether it be a laptop
  1458.        with 3.5 drives, a laptop with an internal harddisk, or IBM PS/2,
  1459.        PC/XT/AT with a DOS formatted disk drive of some type.
  1460.  
  1461.                                 'SERVER'
  1462.                             +---------------+
  1463.                             |  +---------+ o|
  1464.                             |  | Partners| o|
  1465.                             |  |   v5.20 |  |
  1466.                             |  |Copyright|  |
  1467.                             |  +---------+  |
  1468.                             +---------------+
  1469.                        +------------------------+
  1470.                        | IBM   +----+   --=--   |
  1471.                        |  AT   |o   |   --=--   |
  1472.                        |       +----+           |
  1473.                        +------------------------+
  1474.                                      |
  1475.                                      |
  1476.                                   +-----+
  1477.                                   |     | <----- null modem
  1478.                                   +-----+           or
  1479.                                      |           'special' parallel adapter
  1480.                                      |
  1481.                                    mmmmm
  1482.  
  1483.  Agent "A"                                                             Agent "C"
  1484.            wwwww                      wwwww                       wwwww
  1485.              |                          |                           |
  1486.      +-------------+             +-------------+             +-------------+
  1487.      | +---------+ |             | +---------+ |             | +---------+ |
  1488.      | |A:>COPY  | |             | |A:>COPY  | |             | |A:>COPY  | |
  1489.      | |         | |             | |         | |             | |         | |
  1490.      | |         | |             | |         | |             | |         | |
  1491.      | +---------+ |             | +---------+ |             | +---------+ |
  1492.      +-------------+             +-------------+             +-------------+
  1493. +-----------------------+  +------------------------+  +-----------------------+
  1494. | IBM PS/2              |  | Zenith Laptop          |  | Toshiba Laptop        |
  1495. +-----------------------+  +------------------------+  +-----------------------+
  1496.  
  1497.                                    - 19 -
  1498.  
  1499.  
  1500.                              Usage Example NO. 3
  1501.  
  1502.         This simple illustration shows how EQUAL PARTNERS could be used
  1503.        to share data among various PCs. This example shows a "server"
  1504.        attached to a "switch box" by telephone wire. A switch box allows the
  1505.        manual switching of internal connections between one "common" and
  1506.        several other devices attached as "A","B","D" and "E" and such. The
  1507.        devices are connected through "C" and what ever setting the physical
  1508.        switch is pointing to. This arrangement could allow several PCs to
  1509.        be attached to a "server" and data updated on the "server" or the
  1510.        "server" used just to store the data prior to "switching" it to
  1511.        another PC. The "server' does not have to be dedicated, only activat-
  1512.        ed when actual data transfer is needed. This example was actually
  1513.        used by Downlink Systems and also by some of our customers.
  1514.  
  1515.                                 'SERVER'
  1516.                             +---------------+
  1517.                             |  +---------+ o|
  1518.                             |  | Partners| o|
  1519.                             |  |   v5.20 |  |
  1520.                             |  |Copyright|  |
  1521.                             |  +---------+  |
  1522.                             +---------------+
  1523.                        +------------------------+
  1524.                        | IBM   +----+   --=--   |
  1525.                        |  AT   |o   |   --=--   |
  1526.                        |       +----+           |
  1527.                        +------------------------+
  1528.                                      |
  1529.                                      |
  1530.     Twisted-pair wires               |            Twisted-pair wiring
  1531.    +with RS232/EIA adapters          |     <----- with RS232/EIA adapter
  1532.    |and all pins straight thru       |            and pins 2/3 crossed.
  1533.    |                                 |
  1534.    |                                 |
  1535.    |                        +----------------+
  1536.    |                        |        C       |
  1537.    |                        |       /        |
  1538.    |                        |      /         | <---------- Switch box
  1539.    |                        |  a  b     d  e |
  1540.    |                        +----------------+
  1541.    |                           ^  ^     ^
  1542.    |               (a)         |  |     |        (d)
  1543.    |         +------------------  |     ----------------------------+
  1544.    |         |                    |                                 |
  1545.    +------>  |                     +----+                           |
  1546.              |                          | (b)                       |
  1547.              |                          |                           |
  1548.      +-------------+             +-------------+             +-------------+
  1549.      | +---------+ |             | +---------+ |             | +---------+ |
  1550.      | |A:>DBASE | |             | |A:>COPY  | |             | |A:>WORD  | |
  1551.      | |         | |             | |         | |             | |         | |
  1552.      | |         | |             | |         | |             | |         | |
  1553.      | +---------+ |             | +---------+ |             | +---------+ |
  1554.      +-------------+             +-------------+             +-------------+
  1555. +-----------------------+  +------------------------+  +-----------------------+
  1556. | IBM PS/2        --=-- |  | Zenith Laptop          |  | Toshiba Laptop        |
  1557. +-----------------------+  +------------------------+  +-----------------------+
  1558.  
  1559.                                    - 20 -
  1560.  
  1561.   XV.  HOW SOME CUSTOMERS ARE USING EQUAL PARTNERS
  1562.        -------------------------------------------
  1563.  
  1564.        CASE 1.
  1565.        -------
  1566.  
  1567.           This customer has a PC that they use as a server and several
  1568.        PCs that are remotes. The customer wants the remote PCs to run
  1569.        a spreadsheet (Lotus 123) and when through to send the spreadsheet
  1570.        to the server. However, the PARTNERS part of Equal Partners is
  1571.        run on the server as a dedicated task. In otherwords, the server PC
  1572.        is tied up only running PARTNERS.
  1573.  
  1574.          The customer wanted to use the server PC also for his/hers own
  1575.        work and have the office staff send the data to the server at any
  1576.        time without reloading PARTNERS or dedicating the server to the task
  1577.        of just servicing the remotes.
  1578.  
  1579.         This customers solution was to run a commercial product that allows
  1580.        task switching. This task switching software was Software Carousel.
  1581.        Software Carousel allows multiple applications to be loaded into memory
  1582.        BUT only one to actually run at any one time, in the 640k of memory.
  1583.  
  1584.         This is exactly what the customer did, they loaded EQUAL PARTNERS
  1585.        along with several other tasks on the server and with just the press
  1586.        of a key could swap EP into and out of the active 640k, as the needs
  1587.        arose to transfer data from the remotes to the server.
  1588.  
  1589.        CASE 2.
  1590.        -------
  1591.  
  1592.          This customer also needed the server to be used as a non-dedicated
  1593.        machine, even though EQUAL PARTNERS normally requires the server to
  1594.        run as such.
  1595.  
  1596.          The customer went one step further and actually had multiple tasks
  1597.        running on the server while PARTNERS was also running. This was
  1598.        accomplished with a software package called, DESQVIEW,  performing
  1599.        and managing the multitasking environment on the server PC.
  1600.  
  1601.         NOW, a few notes on CASE 1 and CASE 2. Equal Partners was designed
  1602.        to be as well behaved as possible while running under DOS on a PC.
  1603.        In NORMAL processing mode this is true, however in TURBO mode EP
  1604.        takes exclusive use of the computer for short bursts of time.
  1605.  
  1606.         This exclusive use does not allow the computer to service any other
  1607.        tasks, if any, so in a multitasking environment Equal Partners or
  1608.        the other tasks may not co-exist as well or if all (in TURBO mode).
  1609.  
  1610.         Again, we note EQUAL PARTNERS is NOT a LAN of any kind, so YOU
  1611.        bear the responsibility of protecting your disks and their data if
  1612.        you choose to run EP in a shared machine/CPU environment. Basically
  1613.        you have the server and its applications looking at the disks on the
  1614.        server as if they had exclusive use. This is not the case with EP
  1615.        also accessing the server disks and also expecting that it has
  1616.        exclusive use of the data on the server, from the remote.
  1617.  
  1618.         However, if your computer hardware/software configuration works
  1619.        for you, safely, so much the better!
  1620.  
  1621.                                    - 21 -
  1622.  
  1623.  
  1624.  
  1625.  
  1626.   XVI. PROGRAM UPDATE SERVICE
  1627.        -----------------------
  1628.  
  1629.  
  1630.        A license to EP  entitles you to use all future Shareware versions. New
  1631.       "restricted usage"  versions  are generally available  through normal
  1632.       freeware distribution channels, and we prefer that you obtain them that
  1633.       way.
  1634.  
  1635.        A Program disk  containing the  latest version is  returned on every
  1636.       order of $40 or more.  If you wish to purchase a single-user license
  1637.       and want an update disk, please enclose a check or money order for $40.
  1638.  
  1639.        For an additional fee of $50 per year, you can subscribe to our program
  1640.       update service.  Subscribers get up to five program updates  per year
  1641.       mailed to them as new versions come out.  This does not include trivial
  1642.       releases.
  1643.  
  1644.  
  1645.        At present, the normal upgrade fee is $15. For this upgrade fee you get
  1646.       a copy of the new documentation and the upgrade media of your choice,
  1647.       either 5.25 DS/DD diskette or 3.5 720k micro diskette. For orders
  1648.       outside the U.S. add $5.00 to the upgrade fee.
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.                                    - 22 -
  1684.  
  1685.  
  1686.  
  1687.  
  1688.   XVII VERSION NUMBERS
  1689.        ---------------
  1690.  
  1691.  
  1692.        All of our version numbers are given as a number with two decimal
  1693.       places.
  1694.  
  1695.        The units indicate a major revision, such as adding a new feature, maybe
  1696.       such as virtual printer support.
  1697.  
  1698.        The first decimal place (tenths) indicates a minor revision that is
  1699.       not essential, but which may be desired.
  1700.  
  1701.        The second decimal place (hundredths) indicates a trivial revision
  1702.       that will probably only be desired by specific individuals or by die-
  1703.       hard "latest version" fanatics.
  1704.  
  1705.  
  1706.        To sum up: If the units change, then you should get the newer version
  1707.       as soon as you can.  If the tenths change, then you may want to get
  1708.       the newer version, but there's no hurry.  If anything else changes,
  1709.       then you probably shouldn't bother.
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.                                    - 23 -
  1746.  
  1747.  
  1748.  
  1749.  
  1750.   XVIII TECHNICAL REQUIREMENTS AND NOTES
  1751.         --------------------------------
  1752.  
  1753.        Equal Partners uses the RS-232C hardware or  parallel adapter to
  1754.       interface the PCs and provide the 'bridge' to allow the exchange of data.
  1755.  
  1756.        The hardware consists of the standard 8250 uarts and the DB-25
  1757.       or DB-9 connectors and cables (RS232 or telephone wire).
  1758.       However , only pins 2,3, and 7 are used. Also pins 2 and 3
  1759.       (transmit and receive) are required to be crossed-over or
  1760.       you can build or purchase a modem eliminator/null modem.
  1761.  
  1762.        A 'special' parallel adapter is required. The special adapter
  1763.       attaches to one end of a shielded serial cable and the other
  1764.       end of the special adapter to one on the parallel cards. The
  1765.       parallel adapter cannot use telephone wire as more than 8 wires
  1766.       are required.
  1767.  
  1768.       (See your local electronics parts dealer: such as RADIO SHACK:
  1769.       the part number for null modem :  P/N 261496 - at $14.95)
  1770.  
  1771.  
  1772.       This is the basic diagram of the CROSS-OVER pin configuration
  1773.      for the serial null modem ONLY:
  1774.  
  1775.                          DB-25   to   DB-25
  1776.                         --------------------
  1777.  
  1778.  
  1779.                     ------                 ------
  1780.                     |    |                 |    |
  1781.                     |  2 |-----------------|3   |  Pins
  1782.                     |    |                 |    |
  1783.                     |  3 |-----------------|2   |
  1784.                     |    |   ground        |    |
  1785.                     |  7 |-----------------|7   |
  1786.                     ------                 ------
  1787.                      DB-25                 DB-25
  1788.  
  1789.  
  1790.  
  1791.                           DB-9  to   DB-25
  1792.                         --------------------
  1793.  
  1794.  
  1795.  
  1796.                     ------                 ------
  1797.                     |    |                 |    |
  1798.                     |  2 |-----------------|2   |  Pins
  1799.                     |    |                 |    |
  1800.                     |  3 |-----------------|3   |
  1801.                     |    |   ground        |    |
  1802.                     |  5 |-----------------|7   |
  1803.                     ------                 ------
  1804.                      DB-9                  DB-25
  1805.  
  1806.  
  1807.                                    - 24 -
  1808.  
  1809.  
  1810.  
  1811.         The number of wires required (3) indicate that regular telephone
  1812.         4-6-8 wire could be used to connect PCs , over a distance. This
  1813.         applies to serial port usage ONLY.
  1814.  
  1815.          This HAS been tested by Downlink and works very well even at
  1816.         115+ kb. Again, you can check with Radio Shack for a DB-25 to
  1817.         RJ11/RJ45 adapter. The Radio Shack part number is : 276-1405
  1818.         (Modular/EIA adapter kit) and the cost is about $3.00 (male).
  1819.  
  1820.          Also INMAC sells the same type kit. Look in their catalogue under
  1821.         "Modular wiring system" and then look under "Modular EIA adapters".
  1822.         The kit part numbers are 351-3 (male) or 352-3 (female) for the
  1823.         25-pin EIA to 6-pin RJ-11. The cost is $13.00 each. The 9-pin
  1824.         assembled part numbers are: 357-1 (m) and 357-2 (f) for $12.00
  1825.         each.
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.                                    - 25 -
  1870.  
  1871.  
  1872.  
  1873.       The following are notes and considerations both technical
  1874.      and otherwise, these must be noted and HEEDED:
  1875.  
  1876.         1).  Both EQUAL.COM and PARTNERS.COM use COM1 or COM2 as the
  1877.             'bridge'. The port addresses are disabled so that Basic will
  1878.             not interfere, as Basic tries to take over the com ports when
  1879.             loaded, even if does not need them.
  1880.  
  1881.              The parallel ports , LPT1 or LPT2 are used if the parallel
  1882.             port option is selected.
  1883.  
  1884.              The program , 'PARTNERS.COM' will revector  and restore the
  1885.             com ports addresses when it is de-activated however.
  1886.  
  1887.         2).  The program ,'EQUAL.COM', installs resident and attaches itself
  1888.             to DOS, so that once installed its there to stay.
  1889.  
  1890.         3).  The data transfer rate is 38.4  baud for the Shareware  version.
  1891.             The registered user version is fixed at  115+ baud, for serial ,
  1892.             but may be patched to a lower speed if there are hardware problems
  1893.             at 115+. The registered parallel version functions at a variable
  1894.             rate, the transfer rate being dependant on the speed of the slower
  1895.             of the 2 PCs that are connected.
  1896.  
  1897.         4).  Error checking is performed on each block of data. Crc-16 is
  1898.             used to insure the integrity of your financial data and programs.
  1899.  
  1900.         5).  Ram disks with sector sizes between 128 and 512 bytes are
  1901.             supported. This applies to other disk media as well. The sector
  1902.             sizes must be a power of 2.
  1903.  
  1904.         6).  The operating systems on ALL remote(s) and the server SHOULD/MUST
  1905.             be identical. Mixing DOS versions accessing the same data and media
  1906.             MAY/WILL cause problems. Some versions of DOS do not support media
  1907.             types made available in later versions of DOS, so some DOS utilities
  1908.             may not function correctly when accessing disk media or using
  1909.             function calls that were added/modified in later releases of DOS
  1910.             (ex: CHKDSK).
  1911.  
  1912.         7).  Communication baud rates up to 115k+ are possible, for serial ONLY.
  1913.             However, going from 9.6 to 115+ will not give you 10 times the data
  1914.             transfer rate.
  1915.  
  1916.              The internal design of EQUAL PARTNERS allows for a matching of PCs
  1917.             with different CPUs , say a 4.77 mhz processor talking to a 16mhz
  1918.             processor. Obviously the 16 mhz beast could easily overrun the much
  1919.             slower 4.77 cpu. To allow for the possibility of mismatched
  1920.             processor speeds,  EQUAL PARTNERS turns the communications line
  1921.             around no faster than the slowest cpu can handle data. This means
  1922.             that going from 19.2 to 115k will send the data between PCs at that
  1923.             speed, but only as fast as the slower of the two PCs can process
  1924.             and request more data from the faster processor.
  1925.  
  1926.             NOTE:  the above applies to "NORMAL" mode. "TURBO" mode utilizes
  1927.                   ALL the hardware speed to achieve the 4-8kb per second
  1928.                   data transfer rate (independent of the other attached PCs).
  1929.  
  1930.                                  (continued)
  1931.                                    - 26 -
  1932.  
  1933.  
  1934.  
  1935.         8).  Though we have not brought it to your attention before, we give
  1936.             examples of using a "ABC" switch box to link PCs to a server and
  1937.             other examples of the possibility of multiple remotes attached
  1938.             to a "server".
  1939.  
  1940.              Let us CLARIFY AND EMPHASIZE , that to the remote, all virtual
  1941.                     ----------------------
  1942.             disks (even "server" harddisks) are removable.
  1943.  
  1944.              What this means is that each virtual disk can be virtually removed
  1945.             and other virtual disk(s) placed in the virtual (RS232) drive.
  1946.  
  1947.              If this is abused, then disk directories and data files have the
  1948.             potential of being corrupted or destroyed. This all goes back to
  1949.             the original days of DOS 1.0.
  1950.  
  1951.             For example:
  1952.  
  1953.              You could  put a disk in the  "A"  drive and run a program that
  1954.             reads and updates the disk in the "A:" drive. However if you were
  1955.             careless enough to remove the original disk from the "A:" drive and
  1956.             replace with another disk (with different data..etc) then DOS would
  1957.             not know what you had done, and would just write over the new disk.
  1958.             Well , you can see that you could do the same type of thing with the
  1959.             virtual disks on the remote (and server).
  1960.  
  1961.  
  1962.             SO, if you are going to be switching remote PCs on the RS232 link,
  1963.  
  1964.  
  1965.             ALWAYS DISCONNECT OR SWITCH THE REMOTE WHILE THE REMOTE IS AT THE
  1966.             -----------------------------------------------------------------
  1967.            "DOS PROMPT", AND  NEVER WHILE YOU ARE RUNNING AN APPLICATION
  1968.             -----------------------------------------------------------------
  1969.             PROGRAM ON THE REMOTE (AS FILES MAYBE IN USE ON THE SERVER)!!
  1970.             ------------------------------------------------------------------
  1971.  
  1972.  
  1973.         9). If you are going to run the PC as a EQUAL PARTNERS "server" then:
  1974.            NEVER use the DOS commands , "ASSIGN", "JOIN", "SUBST", or other
  1975.            -----
  1976.            DOS commands on the "server" that would "hide" the true type and
  1977.            nature of disk devices.
  1978.  
  1979.             Please heed these rules, unless you know absolutely what you are
  1980.            doing and its effects on DOS and applications. In such situations,
  1981.            if you choose to do so, YOU bear the responsibility for the integrity
  1982.            of your data and the effects on the DOS operating system, on both
  1983.            the server and the remote(s)!!.
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.                                    - 27 -
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  Appendix A - Program Messages.
  1999.  
  2000.  
  2001.  
  2002.       All message text is preceded by a formatted message code.
  2003.  
  2004.      The format of the message code is:
  2005.  
  2006.                    EPxNNNy
  2007.  
  2008.       where :
  2009.  
  2010.            x= 'D' - for 50-50.SYS  program output messages
  2011.  
  2012.               'E' - for EQUALS.COM program output messages
  2013.  
  2014.               'P' - for PARTNERS.COM program output messages
  2015.  
  2016.          and
  2017.  
  2018.  
  2019.            NNN= 000 thru 999, which is the message number for this
  2020.                              message type.
  2021.  
  2022.          and
  2023.  
  2024.            y= 'D' - for Diagnostic type messages. These messages are
  2025.                     normally printed only if a critical error occurs
  2026.                     or the program is in a 'test' or debugging mode.
  2027.  
  2028.               'E' - for Error messages. These type messages indicate
  2029.                     that an unrecoverable error occurred and the program
  2030.                     could not take any corrective action, except to
  2031.                     attempt to return to the DOS prompt.
  2032.  
  2033.               'I' - for Informative messages. These messages are just
  2034.                     to inform you  as to the processing state of the
  2035.                     program at any given time.
  2036.  
  2037.               'W' - for Warning messages. These messages indicate
  2038.                     that an error occurred, but that the program
  2039.                     was able to take corrective action and continue
  2040.                     processing. However, the function the program was
  2041.                     attempting may or may not have been successfully
  2042.                     completed.
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.                                    - A1 -
  2056.  
  2057.  
  2058.       Message Code         Message text and its explanation
  2059.       ------------    ----------------------------------------------------
  2060.  
  2061.         EPD001I - EQUAL PARTNERS Virtual disk driver V5.20
  2062.                  (C)Copyright DOWNLINK SYSTEMS  1987,1991
  2063.  
  2064.                   This is the copyright message displayed from the
  2065.                   virtual disk device driver during PC power-up.
  2066.  
  2067.         EPD002I - 1 virtual disk drive(s) available to DOS
  2068.  
  2069.                   This message indicates the number of additional
  2070.                   disk drives ('virtual') that DOS can access. These
  2071.                   drives may be accessed by the  DOS commands or any
  2072.                   program by using the drive letters assigned, by DOS,
  2073.                   to the virtual disks. Registered users may access up
  2074.                   to 8 virtual disks, the shareware version allows
  2075.                   access to only 1 virtual disk.
  2076.  
  2077.         EPE001E - installation cancelled - COM channel undefined
  2078.  
  2079.                    With version 5.2, the device (serial/parallel) and
  2080.                   the port (COM1/COM2 or LPT1/LPT2) MUST be specified
  2081.                   on the command line. These are the mandatory minimum
  2082.                   parameters required to start Equal Partners.
  2083.  
  2084.                   The program was trying to install, but was unable
  2085.                   to find a communications port address at the desired
  2086.                   memory location or find a 8250 async controller chip
  2087.                   (8250 for serial only).
  2088.  
  2089.         EPE002E - installation cancelled - 50-50 driver not installed
  2090.  
  2091.                   The device driver, 50-50.sys, was not included in the
  2092.                   DOS file 'config.sys'. If your intent is to run this
  2093.                   PC as a 'remote', then see the INSTALLATION section
  2094.                   for the correct program configurations.
  2095.  
  2096.         EPE003E - installation cancelled - ALREADY installed
  2097.  
  2098.                   The program EQUAL.COM has already been installed once.
  2099.                   Multiple installations are not allowed.
  2100.  
  2101.         EPE000I - EQUAL activated - Communications link is (COMx or LPTx)
  2102.  
  2103.                   This message reflects that the installation of EQUAL is
  2104.                   in progress and that the Communications port, COMx or LPTx
  2105.                   was the port selected to link the "remote" to the "server"
  2106.  
  2107.         EPE001I - EQUAL running at - ???kb (baud) in XXXXXX mode
  2108.  
  2109.                   This informative message indicate the "mode" and the
  2110.                   internal speed at which communications and data transfers
  2111.                   are taking place. The "mode" (indicate by XXXXXX) will be
  2112.                   either "NORMAL" or "TURBO". The baud (indicated by ???) will
  2113.                   range from 9.6kb to 115kb or 250 for parallel. Typing in the
  2114.                   command , EQUAL,  (with or without new mode) will display
  2115.                   this message also.
  2116.  
  2117.                                    - A2 -
  2118.  
  2119.  
  2120.       Message Code         Message text and its explanation
  2121.       ------------    ----------------------------------------------------
  2122.  
  2123.         EPE002I - EQUAL installed - Virtual drives C: thru C: available for use
  2124.  
  2125.                   This is the most important type 'I' message that is
  2126.                   displayed.  This message reflects the  additional 'drive'
  2127.                   letters you use on all DOS commands and in programs, to
  2128.                   access data on the 'server' PC.
  2129.                      The drive letters displayed depends on the number of
  2130.                   virtual drives requested (up to 8 allowed) on the
  2131.                   'device=50-50.sys' statement in the DOS 'config.sys' file.
  2132.  
  2133.         EPE003I - EQUAL printing  - output to LPT1 will print on .......
  2134.  
  2135.                   This messages indicates where the 'remote' is sending its
  2136.                   printer output that goes to LPT1. The message will show
  2137.                   destination as either 'this PC' or 'SERVER'. A physical
  2138.                   printer, on the remote' is not required to use the "/P"
  2139.                   option on the EQUAL command line.
  2140.  
  2141.         EPE999I - EQUAL shutdown - returning to DOS
  2142.  
  2143.                   This message indicates that EQUAL.COM is returning to
  2144.                   DOS. See any additional messages for the exact reason.
  2145.  
  2146.         EPP001E - installation cancelled - COM channel undefined
  2147.  
  2148.                    With version 5.2, the device (serial/parallel) and
  2149.                   the port (COM1/COM2 or LPT1/LPT2) MUST be specified
  2150.                   on the command line. These are the mandatory minimum
  2151.                   parameters required to start Equal Partners.
  2152.  
  2153.                   The program was trying to install, but was unable
  2154.                   to find a communications port address at the desired
  2155.                   memory location or find a 8250 async controller chip.
  2156.  
  2157.         EPP002E - installation cancelled - EQUAL is already installed
  2158.  
  2159.                   The program is trying to be installed on a machine
  2160.                   that already has the EQUAL.COM program installed.
  2161.                   You can't make one machine both a 'remote' and a
  2162.                   'server'.
  2163.  
  2164.         EPP997E - PARTNERS shutdown     - memory allocation error during install
  2165.  
  2166.                   The program was requesting a 64k block of contiguous
  2167.                   memory from DOS, and DOS could not satisfy the request.
  2168.                   Insure you have sufficient memory by adding memory to
  2169.                   your system or removing unneeded ram-resident programs.
  2170.  
  2171.         EPP998E - PARTNERS shutdown     - memory modify error during install
  2172.  
  2173.                   The program was being "well-behaved' and returning all the
  2174.                   memory to DOS that it did not need. This indicates that the
  2175.                   program has been modified incorrectly or that DOS has been
  2176.                   corrupted. At this point it would be best to re-boot the
  2177.                   PC, and reload a fresh copy of DOS and "PARTNERS".
  2178.  
  2179.                                    - A3 -
  2180.  
  2181.  
  2182.  
  2183.       Message Code         Message text and its explanation
  2184.       ------------    ----------------------------------------------------
  2185.  
  2186.         EPP000I - PARTNERS activated - Communications link is (COMx or LPTx)
  2187.  
  2188.                   This message reflects that the installation of PARTNERS
  2189.                   is in progress and that the Communications port, COMx or LPTx
  2190.                   was the port selected to link the "server" to the "remote".
  2191.  
  2192.         EPP001I - PARTNERS shutdown      - by a REMOTE is ........
  2193.  
  2194.                   This message indicates whether the server (PARTNERS) can be
  2195.                   automatically shutdown (return to DOS) by a remote (/D).
  2196.                    Remote shutdown support must be enabled on the server or
  2197.                   the remotes request is ignored. This option may be toggled
  2198.                   (changed) with the appropriate function key after PARTNERS
  2199.                   is running.
  2200.  
  2201.         EPP002I - PARTNERS printing      - by a REMOTE is ........
  2202.  
  2203.                   This message indicates whether the server (PARTNERS) will
  2204.                   process printer output to LPT1 that has been sent from the
  2205.                   remote.
  2206.                    Remote printer support must be enabled on the server or
  2207.                   the remotes request returns a printer timeout. This option
  2208.                   may be toggled (changed) with the appropriate function key
  2209.                   after PARTNERS is running.
  2210.  
  2211.         EPP003I - PARTNERS write protect - on all disks is ......
  2212.  
  2213.                   This message indicates whether the server (PARTNERS) will
  2214.                   perform automatic write protect on all disk drives read by
  2215.                   a remote. This would be the same as placing a 'write protect'
  2216.                   (silver/black) tab on a floppy. In otherwords, you can read
  2217.                   a disk but NOT write to it. Since virtual disks are removable
  2218.                   , from a remotes point of view, a virtual 'write protect tab'
  2219.                   option provides you with similar functionality.
  2220.  
  2221.         EPP998I - PARTNERS installed -waiting for remote response
  2222.  
  2223.                   You have entered PARTNERS from the DOS prompt or in
  2224.                   a batch file. PARTNERS is now installed (not resident)
  2225.                   and is waiting for input on the communications port.
  2226.                   The programs EQUAL.COM and 50-50.SYS have to be installed
  2227.                   on the "remote" computer to complete the "bridge",so
  2228.                   that data may be freely transferred between computers.
  2229.  
  2230.         EPP999I - PARTNERS shutdown - returning to DOS
  2231.  
  2232.                   You have either pressed the 'ESC' key or installation
  2233.                   failed.
  2234.  
  2235.         EPP001W - Invalid I/O request - flushing input buffer
  2236.  
  2237.                   Extraneous or corrupted information was received. The
  2238.                   programs only recourse is to ignore the data, flush
  2239.                   all buffers and try to get in sync with the other PC.
  2240.  
  2241.                                    - A4 -
  2242.  
  2243.  
  2244.  
  2245.       Message Code         Message text and its explanation
  2246.       ------------    ----------------------------------------------------
  2247.  
  2248.  
  2249.         EPP001D - AX=      BX=     CX=    DX=
  2250.  
  2251.                   This message displays the internal register states.
  2252.                   The message is normally display only when a critical
  2253.                   error occurs or the programs debugging mode is active.
  2254.  
  2255.         EPP002D -     -
  2256.  
  2257.                   This message is preceded by message code EPP001D.
  2258.                   Several additional message lines will be displayed
  2259.                   indicating the reason for this diagnostic message.
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.                                    - A5 -
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  Appendix B - Site License
  2309.  
  2310.  
  2311.  
  2312.                                   SITE LICENSE
  2313.  
  2314.  
  2315.  
  2316.      Corporate users may wish to obtain a site license for the use of EP.
  2317.      The site license applies only to one geographical area, not to exceed
  2318.      a 50 mile radius. Additional site licenses are required for each
  2319.      unique geographical location.
  2320.  
  2321.        Please use the order form in this manual to request a site license.
  2322.  
  2323.      Site licenses are now negotiated on an individual basis.  License fees
  2324.      vary depending on the number of computers on which EP  will be used.
  2325.  
  2326.      Equal Partners is now ONLY licensed per single unit quantities of,
  2327.  
  2328.  
  2329.          1 single unit license -  $40 each    ($15 upgrade fee each)
  2330.  
  2331.  
  2332.          A site license may be requested and will be negotiated on an
  2333.        individual basis.
  2334.  
  2335.  
  2336.      The following page is a license agreement, which should be signed
  2337.      and sent with your payment when ordering a commercial license.
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.                                    - B1 -
  2366.  
  2367.                           Commercial License Agreement
  2368.  
  2369.      The use of EP  in a commercial environment or government organization
  2370.      is granted under the following terms:
  2371.  
  2372.      1.  Payment of the license fee must be made payable to: D. Conner
  2373.  
  2374.          The fee is based on the number of computers which will be used
  2375.          to run EP , as follows:
  2376.  
  2377.          Equal Partners is now ONLY licensed per single unit quantities of,
  2378.  
  2379.  
  2380.             1 single unit license -  $40 each    ($15 upgrade fee each)
  2381.  
  2382.  
  2383.      2.  You may use EP  on the number of computers included in the license
  2384.          fee.  If you have negotiated a site license, then you may use EP
  2385.          on any number of computers within your organization, within a given
  2386.          geographical area.
  2387.  
  2388.      3.  You may make copies of the program and documentation, in their
  2389.          original,  unmodified form. You may distribute these copies, within
  2390.          the limits of the number of copies licensed.
  2391.  
  2392.      4.  You may use all future "restricted-usage" Shareware versions of EP
  2393.          under this license.
  2394.  
  2395.          The latest version is available from Downlink  for a small service
  2396.          charge of $5.00 for shareware version, on either 5.25 or 3.5 DS/DD)
  2397.  
  2398.      5.  You may NOT modify the program or charge a fee for copying or
  2399.          distributing the program or its documentation.
  2400.  
  2401.      6.  It is your responsibility to make the necessary copies and to
  2402.          deliver them to the computers which they will be used on.
  2403.  
  2404.      7.  We are not responsible for anything that may happen or not happen
  2405.          if you use EP.
  2406.  
  2407.  
  2408.      8.  You are required to complete and sign this form and the ORDER form
  2409.          , and return them to Downlink Systems. This especially applies
  2410.          to any purchases that were made via 1-800 credit card order.
  2411.  
  2412.          I agree to abide by the terms and conditions of this license.
  2413.  
  2414.          _____________________________         __________________________
  2415.          Signature                             Date
  2416.  
  2417.          _____________________________
  2418.          Name (please print or type)
  2419.  
  2420.          _____________________________
  2421.          Title
  2422.  
  2423.          _____________________________
  2424.          Company
  2425.  
  2426.                                    - B2 -
  2427.  
  2428.  
  2429.  Appendix C - Ordering
  2430.  
  2431.                                    ORDER FORM
  2432.  
  2433.  
  2434.      Check which items you wish to purchase:
  2435.  
  2436.          (_) Noncommercial license for the use of EP.
  2437.  
  2438.          (_) Commercial license for the use of EP on ___ computers
  2439.  
  2440.          (_) Program update fee of $_____  for each of __ computers that EP
  2441.              is currently licensed on.
  2442.  
  2443.          (_) Additional, program update subscription service, $50/year.
  2444.              (not more than five updates, does not include trivial changes,
  2445.               and ONLY applies to licenses up to 10 machines.)
  2446.  
  2447.          (_) Update media is :  (_) 5-1/4 floppy  |  (_) 3-1/2 micro floppy
  2448.  
  2449.  
  2450.          (_) Payment of $_____ is enclosed (check or money order),
  2451.                 |
  2452.                 +------> payable to : D. Conner.
  2453.                          ----------
  2454.  
  2455.              Signature: ________________________________
  2456.  
  2457.          _______________________________________________
  2458.          Name
  2459.  
  2460.          _______________________________________________
  2461.  
  2462.  
  2463.          _______________________________________________
  2464.          Address
  2465.  
  2466.          ______________________   ________  ____________
  2467.          City                     State     Zip
  2468.  
  2469.  
  2470.          _______________________________________________
  2471.          Country
  2472.  
  2473.  
  2474.      ***       Send check or money orders payable to : D. Conner      ***
  2475.                -------------------------------------------------
  2476.        (all other endorsements will be returned and order not processed)
  2477.  
  2478.      Send this completed form to:
  2479.  
  2480.                                   D. Conner
  2481.                                   Downlink Systems
  2482.                                   5226 Via Hacienda
  2483.                                   #115
  2484.                                   Orlando Fl.     32809
  2485.  
  2486.                                   U.S.A.
  2487.  
  2488.                                    - C1 -
  2489.  
  2490.  
  2491.  
  2492.  
  2493.       For program disk orders outside the U.S., please add an additional $5,
  2494.      and enclose a check or money order payable in U.S. currency and
  2495.      drawn on a U.S. bank. Any checks/money orders that cannot be deposited
  2496.      --------------------
  2497.      in a U.S. bank WILL be returned without processing of the order.
  2498.  
  2499.       For commercial license orders, please enclose a signed copy of the
  2500.      the license agreement.
  2501.  
  2502.       Inquires for Corporate wide unlimited usage licenses are welcome.
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.                                    - C2 -
  2551.  
  2552.  
  2553.  Appendix D - Comments
  2554.  
  2555.                               USER COMMENT FORM
  2556.  
  2557.  
  2558.       If you have found any errors in this documentation that you would like
  2559.      to bring to our attention, please indicate them below. Please indicate
  2560.      them by page number if possible. If there are other improvements to the
  2561.      documentation, product features that you would like us to consider,
  2562.      or any ways you are using EQUAL PARTNERS that you would like to share,
  2563.      please indicate them here (for version 5.2):
  2564.  
  2565.    ____________________________________________________________________________
  2566.  
  2567.    ____________________________________________________________________________
  2568.  
  2569.    ____________________________________________________________________________
  2570.  
  2571.    ____________________________________________________________________________
  2572.  
  2573.    ____________________________________________________________________________
  2574.  
  2575.    ____________________________________________________________________________
  2576.  
  2577.    ____________________________________________________________________________
  2578.  
  2579.    ____________________________________________________________________________
  2580.  
  2581.    ____________________________________________________________________________
  2582.  
  2583.    ____________________________________________________________________________
  2584.  
  2585.    ____________________________________________________________________________
  2586.  
  2587.    ____________________________________________________________________________
  2588.  
  2589.    ____________________________________________________________________________
  2590.  
  2591.    ____________________________________________________________________________
  2592.  
  2593.    ____________________________________________________________________________
  2594.  
  2595.    ____________________________________________________________________________
  2596.  
  2597.    ____________________________________________________________________________
  2598.  
  2599.    ____________________________________________________________________________
  2600.  
  2601.    ____________________________________________________________________________
  2602.  
  2603.    ____________________________________________________________________________
  2604.  
  2605.    ____________________________________________________________________________
  2606.  
  2607.    ____________________________________________________________________________
  2608.  
  2609.    ____________________________________________________________________________
  2610.  
  2611.  
  2612.                                    - D1 -
  2613.  
  2614.  
  2615.  
  2616.  Appendix E - Mailing
  2617.  
  2618.  
  2619.                             CHANGE OF ADDRESS FORM
  2620.  
  2621.  
  2622.       Please let us know when you change your address, so that we can keep
  2623.      you informed of product improvements, etc.
  2624.  
  2625.  
  2626.    NAME: ______________________________________________________________________
  2627.  
  2628.    COMPANY:____________________________________________________________________
  2629.  
  2630.    SERIAL NUMBER:______________________________________________________________
  2631.  
  2632.    Old Address:
  2633.  
  2634.    ____________________________________________________________________________
  2635.  
  2636.    ____________________________________________________________________________
  2637.  
  2638.    CITY:______________________________________STATE:______ZIP:_________________
  2639.  
  2640.    ____________________________________________________________________________
  2641.  
  2642.    New Address:
  2643.    ____________________________________________________________________________
  2644.  
  2645.    ____________________________________________________________________________
  2646.  
  2647.    ____________________________________________________________________________
  2648.  
  2649.    CITY:______________________________________STATE:______ZIP:_________________
  2650.  
  2651.    Telephone:__________________________________________________________________
  2652.  
  2653.    ____________________________________________________________________________
  2654.  
  2655.    Effective Date of New Address:______________________________________________
  2656.  
  2657.  
  2658.                                 MAIL TO :
  2659.                                -----------
  2660.  
  2661.  
  2662.                           D. Conner
  2663.                           5226 Via Hacienda
  2664.                           #115
  2665.                           Orlando Fl.    32809
  2666.  
  2667.                           U.S.A.
  2668.  
  2669.  
  2670.  
  2671.  
  2672.                                    - E1 -
  2673.  
  2674.